home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / sprtrv21.zip / SYSOP.DOC < prev   
Text File  |  1993-05-02  |  16KB  |  402 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                            NCAA SPORTS TRIVIA
  11.                               SYSOP'S MANUAL
  12.  
  13.                                  v2.1
  14.  
  15.                               May 1, 1993
  16.                          PCBoard 14.x and GAP 4.x
  17.                            WILDCAT!, SPITFIRE
  18.                              QBBS, RBBS, RA
  19.                                   WWIV
  20.  
  21.                                    by
  22.  
  23.                              Dennis Maidon
  24.  
  25.                           The Parole Board BBS
  26.  
  27.                (919) 965-4696 - US Robotics Dual Standard
  28.  
  29.             All nodes are running US Robotics Dual Standards
  30.  
  31.                             Free Advice BBS
  32.  
  33.                         (919) 934-1002 - Node 1
  34.  
  35.                      US Robotics HST 14.4k / V42bis
  36.  
  37.                            -=-=-=-=-=-=-=-=-
  38.  
  39.                                 OVERVIEW
  40.                                 ________
  41.  
  42.  
  43. CONGRATULATIONS!  You and your users will find this Trivia door
  44. entertaining and educational.  It consists of approximately 100 or
  45. so questions that were carefully selected for your entertainment.
  46. The door displays a "Trivia Royalty" bulletin to the caller while
  47. it creates bulletins and logs for your use.  Best of all..this door
  48. is not crippleware.  It isn't full of advertisements and
  49. limitations...best of all I don't charge an arm and a leg.  You'll
  50. also find we are responsive to your questions.  If you need help or
  51. have a suggestion for improving this product, let me know!
  52.                      FILES AND DESCRIPTIONS
  53.                      ______________________
  54.  
  55. The archive includes the following files:
  56.  
  57.      SPRTRV.EXE     -- The main executable file
  58.      SAMPLE.CFG     -- The sample configuration file
  59.      SPRTRV.DAT   -- The main trivia data file
  60.      SPRTRV.HIS   -- Release History and changes
  61.      SCREENS.ZIP    -- Screens for the SPRTRV\SCREENS sub directory
  62.          ^┌──WELCOME.ANS  -- The program color Welcome Screen,
  63.          ││                  (Can be modified by Sysop).
  64.          ││  WELCOME.ASC  -- The program mono Welcome Screen
  65.          └┤                  (Can be modified by Sysop).
  66.           │  GAMEPLAY.ANS -- ANSI Game screen ─┐ DO NOT Modify!
  67.           │  GAMEPLAY.ASC -- ASCii Game Screen─┘
  68.           │  INSTRUCT.ANS -- The color user instruction file
  69.           └──INSTRUCT.ASC -- The mono user instruction file
  70.      SYSOP.DOC    -- The installation instructions...(this file)
  71.      QUIKUP.DOC   -- Quick and Dirty installation instructions.
  72.      REGISTER.TXT -- Information and registration form...This will
  73.                      give you a personalized door, voice or bbs   
  74.                      support services, new issues of master.dat   
  75.                      files, a clear conscience and a still poor but
  76.                      happy door programmer.
  77.      SAMPLE.BAT      Sample door batch file
  78.      
  79. This ZIP file was created using the -AV function of PKZIP.  If my
  80. AV is missing then this file may not be complete or has been
  81. tampered with.  Complete and current editions of this program are
  82. always available for D/L on The Parole Board BBS.  If the AV is
  83. missing please complain to your sysop to stop the practice of
  84. removing AV's as this is your assurance from the programmer that
  85. the file is complete and virus free.
  86.  
  87.  
  88.                               INSTALLATION
  89.                               ____________
  90.  
  91.    Installation is quite simple and straight-forward. Follow these
  92. steps and example and you should be up and running in a matter of
  93. minutes.  Although SPRTRV is an easy program to install on most any
  94. BBS, there may be some Sysop who has trouble.  Support is available
  95. in those situations.
  96.  
  97.  
  98.       1) Create a directory to hold all SPRTRV files
  99.  
  100.       2) Unzip SPRTRVxx.ZIP into the above directory
  101.  
  102.       3) Run INSTALL.BAT
  103.  
  104.       4) Create a configuration file, with a name of your choice
  105.          or modify the SAMPLE.CFG file which is enclosed.
  106.  
  107.       5) Create a door batch file or use the sample enclosed.
  108.  
  109.  
  110.       6) Modify your particular BBS System Menus to add the
  111.          door.  The BBS setup various depending on the type BBS   
  112.          software you are running.  We assumed you are familiar   
  113.          with the general DOOR setup on your system.  Therefore our
  114.          description includes only examples of the SPRTRV specific
  115.          configuration file and door batch file.  Refer to your
  116.          BBS documentation for door installation on your
  117.          particular software.
  118.  
  119.  
  120.  
  121. BBS USER FILES
  122.  
  123.      The BBS user file provides information to SPRTRV!!, such as COM
  124.      port, user name, time allowed in the door, etc.  This file is
  125.      necessary for SPRTRV to function.  The complete path\filename of
  126.      the BBS user file must be passed to SPRTRV.EXE as the 1st
  127.      parameter in the command line.  The user file is created by
  128.      your BBS EACH time a user runs a door....The BBS USER file has
  129.      a different name on each type of BBS.  When you create your
  130.      SPRTRV configuration file, you must tell SPRTRV the name for your
  131.      particular BBS system.
  132.   
  133.      The following is a list of the user files used by the        
  134.      BBS types we support (we included a typical path).
  135.  
  136. drive\dir\filename
  137.    C:\WILDCAT\CALLINFO.BBS              ──┐  <- For Wildcat!
  138.    C:\WC30\WCWORK\NODE1\USERINFO.DAT      │  <- For Wildcat! 3.x
  139.    C:\PCB\PCBOARD.SYS                     │  <- For PCBoard using PCBOARD.SYS
  140.                                           │     only
  141.    C:\PCB\USERS                           │  <- For PCBoard using USERS only
  142.    C:\BBS\DOOR.SYS                        │  <- For Systems which support
  143.                                           │     DOOR.SYS
  144.    C:\BBS\DORINFOx.DEF                    │  <- For QBBS/RBB/RA.  Replace x
  145.                                           │     with Node#.
  146.    C:\BBS\SFDOORS.DAT                     │  <- For Spitfire
  147.    C:\BBS\CHAIN.TXT                    ───┘  <- For WWIV
  148.  
  149.  
  150. CONFIGURATION FILE
  151.  
  152. One (and only ONE) of the above will be LINE 1 of your
  153. configuration file. You MUST specify the path and name (including
  154. any extension) correctly if you expect SPRTRV to find it.  Sample for
  155. Lines 2 through 10 are:
  156.  
  157.    The Parole Board BBS         <- Your BBS Name
  158.    Dennis                       <- SysOp's First Name
  159.    Maidon                       <- SysOp's Last Name
  160.    00000                        <- Registration Number
  161.    100                          <- Minimum security level allowed 
  162.                                    in door.
  163.    35                           <- Maximum questions allowed per visit
  164.                                    to the door.
  165.    C:\WC\BULL\BULL1.SCR         <- Path and Name of Color Bulletin
  166.    C:\WC\BULL\BULL1.BBS         <- Path and Name of ASCii Bulletin
  167.    WC                           <- WC Create WC!3.x specific bulls
  168.                                    PCB Create PCBoard specific bulls
  169.                                    Blank for ANSI & ASCii
  170.    2                            <- Number of times allowed to play door
  171.                                    each day.
  172.    RIP                          <- "RIP" create RIP style bulletin
  173.                                    "N"  do not create RIP bulls
  174.  
  175.  
  176.      Edit the Sample.CFG file to suit your individual BBS.  You
  177. must have all 12 lines and no extra characters.
  178.  
  179.   Line 1:  This line points to where SPRTRV.EXE will find the callers
  180.            information file.  Just include the line that your     
  181.            particular BBS uses.  DO NOT put all of them in the CFG 
  182.            file.
  183.  
  184.    Line 2:  Place the name of your BBS on this line.
  185.  
  186.    Line 3:  SysOp's first name goes here.
  187.  
  188.    Line 4:  SysOp's last name goes here.
  189.  
  190.    Line 5:  Your Registration Number goes here if registered.  If
  191.             you haven't registered you can still use the          
  192.             door...just enter 00000 until you get your registration 
  193.             number.
  194.  
  195.    Line 6:  The minimum security level that is allowed in the door.
  196.  
  197.    Line 7:  Maximum number of questions allowed per visit to the door.
  198.             I would suggest 25-30 as a reasonable number.  The smaller
  199.             this number, the more likely that the users will continue to
  200.             use the door.
  201.  
  202.    Line 8:  Enter the complete path and name of the ANSI bulletin
  203.             that you want SPRTRV to create.
  204.  
  205.    Line 9:  Enter the complete path and name of the ASCii bulletin
  206.             that  you want SPRTRV to create.
  207.  
  208.    Line 10:  "WC" to create WC!3.x specific bulletins or NO for ANSI and
  209.              ASCii bulletins. "PCB" on this line will enable the program
  210.              to create PCBoard specific color bulletins.  If you Config
  211.              for WC! or PCB bulletins, Place the name of the bulletin
  212.              on Line 8 of the CFG file.  Be sure to add the ".BBS"
  213.              extension to it.  You may leave Line 9 blank but it still
  214.              MUST be included in the CFG file.
  215.  
  216.    Line 11:  Number of times users are allowed to play the door each
  217.              day
  218.  
  219.    Line 12:  Place "RIP" on this line to enable RIP bulletins.  Place
  220.              "N" to disable them.
  221.  
  222.  
  223.          If you use the sample CFG file be sure to remove all
  224. remarks and use  a pure ASCII editor such as EDLIN or QEDIT.  Word
  225. processors typically leave hidden control codes. Those hidden codes
  226. could cause the program to depart for worlds unknown.  Save your
  227. newly edited file using any name you want....suggested SPRTRV1.CFG.
  228.  
  229.  
  230.  
  231.  
  232.  
  233. DOOR BATCH FILE
  234.  
  235.          Create a batch file or modify the sample SPRTRV.BAT file
  236.          supplied. This is what you need:
  237.  
  238.   @ECHO OFF
  239.   CLS                   Keeps a clean screen (optional)
  240.   CD \DOORS\SPRTRV      Change to the SPRTRV door files directory
  241.   SPRTRV SPRTRV1.CFG    Run SPRTRV using SPRTRV1.CFG configuration
  242.                           Change back to the WCAT BBS directory
  243.                           Restart the BBS.  On BBSs which shell to
  244.                           dos to run the door this line may be    
  245.                           omitted or maybe the word "EXIT."  Check 
  246.                           your BBS door instructions.
  247.  
  248. The above DOOR.BAT file is for a Wildcat! 3.x system using SWAP instead
  249. of TERMINATE for doors.
  250.  
  251. MULTIPLE NODES
  252.  
  253.         Create a configuration file for each node.  Each file     
  254.         should have a unique name.  
  255.  
  256.         EX: SPRTRV1.CFG  SPRTRV2.CFG
  257.  
  258.         SPRTRV has been tested under LIVECAT and DESQVIEW and performs
  259.         very well under either or both.
  260.  
  261. COMM PORT IRQs
  262.  
  263. SPRTRV is written using DoorFrame.   DoorFrame supports COM 1-4 on the
  264. standard IRQ's - COM1 or COM3 as a standard uses IRQ4 while  COM2
  265. and COM4 use IRQ3.  If your system uses a non-standard IRQ, add the
  266. IRQ  number after the configuration filename. Let's assume your
  267. Door is called FOOBAR and you want to use COM1 but non-standard
  268. IRQ5. The command line  passed to your Door would be:
  269.  
  270.         FOOBAR FOOBAR.CFG /5
  271.  
  272.       The /5 tells DoorFrame to use IRQ5 rather than the standard
  273. IRQ4 normally used with COM1. No /x parameter is needed for the
  274. standard IRQ's.
  275.  
  276. Fossil Driver Support
  277. ---------------------
  278. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  279. Fossil driver instead of the standard COM ports, just put /FD on the command
  280. line when running the door. For example:
  281.  
  282.      MYDOOR MYDOOR.CFG /FD
  283.      MYDOOR MYDOOR.CFG *FD
  284.  
  285. indicates that a Fossil driver is present and should be used. If no Fossil
  286. driver is detected, DoorFrame will print a message to that effect and exit
  287. the door gracefully.
  288.  
  289.  
  290. TIPS AND TRAPS
  291.  
  292.       Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC
  293. files if they are included in the package.  They sometimes contain
  294. some very useful information. <G>  
  295. Of course you can do like me, just set the darn thing up without
  296. the docs then fuss at the door author for not making it simple
  297. enough to work the first time.
  298.  
  299.       IF You get an error...check every path to make sure you typed
  300. it correctly.  Check the file name...does it match exactly?  Does
  301. the configuration filename match?  Did you leave off the
  302. configuration file extension?   Do you have the correct BRUN module
  303. in a directory on your path?  If all those seem correct and the
  304. door still won't work...call me......preferably not in the middle
  305. of the night...no door is that important.
  306.  
  307.       When the door is in use...you can use the sysop options
  308. listed at the bottom of your screen to chat, increase or decrease
  309. the users time or log the user off.
  310.  
  311.  
  312.  
  313.  
  314.                                 MISCELLANEOUS NOTES
  315.                                 ===================
  316.  
  317. DoorFrame requires DOS 3.x and up since all files are opened in SHARED mode.
  318.  
  319. When using PCBOARD.SYS, SPRTRV requires that PCBOARD.DAT be in the same
  320. directory as PCBOARD.SYS. SPRTRV also accesses the USERS file.
  321.  
  322. When using USERS.SYS, SPRTRV also accesses PCBOARD.SYS, PCBOARD.DAT and the
  323. USERS file.
  324.  
  325. The DOOR.SYS used by SPRTRV is the standard 52 line GAP (tm) file.
  326.  
  327. The CALLINFO.BBS used by SPRTRV currently contains 36 lines.
  328.  
  329. DoorFrame doors may now make use of the IRQ environment variable. For
  330. example, instead of DOOR DOOR.CFG /5 you can use DOOR DOOR.CFG /%IRQ%.
  331. (I use this method here on The Parole Board for WC! and it works just
  332. fine.  Use "/%WCIRQID%".)
  333.  
  334. DoorFrame is now aware of the PCBoard environment variables %PCBDRIVE% and
  335. %PCBDIR%. If it finds those two variables on the first line of the .CFG
  336. file it will substitute the correct drive and path. The %WCNODEID%
  337. variable is also recognized.
  338.  
  339.  
  340.  
  341.                               LEGALITIES
  342.                               __________
  343.  
  344.  
  345.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS
  346. IS"  WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT
  347. NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND
  348. FITNESS  FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE
  349. INVOLVED WITH THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE
  350. FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY
  351. USE THEREOF OR BREACH OF ANY WARRANTY.
  352.  
  353.  
  354.                              DISTRIBUTION
  355.                              ____________
  356.  
  357.    You may make this file available for downloading from your BBS
  358. or you may  upload it to any BBS of your choice, provided that you
  359. do not make any  changes to the contents of the archive (ZIP file).
  360. The archive and its  individual contents may not be used by any
  361. service that charges any money whatsoever, without the written
  362. permission of the author.
  363.  
  364.                              REGISTRATION
  365.                              ____________
  366.  
  367.    I am not a subscriber to the "Crippleware" concept, and this
  368. program  reflects that philosophy. This is a full-featured program,
  369. whose functionality is not hampered in any way, whether you
  370. register it or not.  It is only $15 to register this door.  Registered
  371. SysOps will receive an added utility that will allow you to edit and/or
  372. add questions to the database.
  373.  
  374.    Remember, whether you are registered or not, should you have any
  375. problems, questions or suggestions for improvements, be sure to
  376. drop me a message on either of the aforementioned BBS or via the
  377. DOORS or SYSOP conference on RIME(tm), Node ID = PAROLE.
  378.  
  379.  
  380.                                  THANKS
  381.                              --------------
  382.  
  383.     Special thanks goes out for my wife who is definitely a
  384.     "Computer Widow".
  385.  
  386.     Ted Freeman the author of DoorFrame, a first class BBS Doors
  387.     Development Library.
  388.  
  389.     My BBS users who have had to endure constant badgering to help 
  390.     me test the programs that I have written.
  391.  
  392.     A *VERY SPECIAL THANKS* to Mustang! Software for developing the 
  393.     greatest BBS Software on the market, WILDCAT! 3.x.  And about 
  394.     to be even better when they revamp the on-line chat feature.
  395.  
  396.     Liane Benway, SysOp, Running Wild !!! in Norcross, GA.  Without
  397.     Liane, you wouldn't have these fine DOCs.
  398.  
  399.     Ned Attayek, SysOp, Free Advice BBS in Smithfield, NC for his
  400.     tireless effort in coming up with all these questions.
  401.  
  402.